Skip to main content
Feedback

Migrating an environment to or from Boomi API Gateway

The Environment Migration feature allows you to migrate environments to or from an API Gateway on the Environment Migration tab of the API Gateways page (Configure Server > Gateways)

Complete the environment migration steps to attach an environment to an API Gateway, move an environment from one API Gateway to another API Gateway, or detach an environment from an API Gateway.

Once you click Create Migration, a record of the migration is created in the table on the Environment Migration tab. This allows you to click Save and Close or Close Migration to leave the migration wizard at your current step and return to that location later.

You can start a migration and save your progress to return to it later. The table on the Environment Migration tab shows the status and details for in-progress migrations:

  • Current Step: Shows the step in the 3-step migration process you are currently on.
  • Environment: Identifies the environment being migrated.
  • Moving From: Indicates the API Gateway the environment is being moved from (or is empty if unattached).
  • Moving To: Indicates the API Gateway the environment is being moved to (or is empty if unattached).
  • Delete: Provides the option to delete the in-progress migration.

If there are no in-progress migrations, the table will be empty with the option to Create a New Migration.

To migrate an environment:

  1. Go to the Boomi Enterprise Platform URL: https://platform.boomi.com.

  2. Navigate to the Services tab and select API Management. The Deployed APIs page opens.

  3. Navigate to the Configure Server > Gateways.

  4. Navigate to the Environment Migration tab and click Create a New Migration. The Migrate an Environment wizard opens.

  5. Select the environment that you want move on or off an API Gateway or to a different API Gateway, and click Create Migration.

    Clicking Create Migration creates a record of the migration in the table on the Environment Migration tab that enables you to close the migration at the end of any step and return to your current location at a later time.

  6. Select the environment's destination: a different API Gateway or off its API Gateway (if it is already attached to an API Gateway). Click Save and Continue.

  7. Specify the environment endpoint path for REST Endpoints, SOAP operations, OData entities, and GraphQL Endpoints.

    The environment endpoint path is included in the complete endpoint URL. The complete endpoint URL consists of: Gateway’s Public URL + Environment Endpoint Path + Base API Path.

    note

    The default value for the GraphQL Endpoints path field is:

    • ws/graphql for existing environments.
    • Empty for new environments.

  8. Click Save and Continue.

    The Step 1 Summary page opens to allow you to review the selections you have made so far.

  9. Review your selections and then click Save and Continue to continue to Step 2: runtime Configuration.

  10. On the runtime Configuration page:

    • If you are moving the environment to an API Gateway or to a different API Gateway, ensure that you have at least one runtime with its API Type set to Advanced and its Authentication Type set to Gateway. If you don't, select a different API Gateway that contains the correct configuration or make changes in Runtime Management to correct the existing Atoms on the environment.
    • If you are moving the environment off an API Gateway, ensure that you have at least one runtime with its Authentication Type set to something other than Gateway. If all of the Atoms have the Authentication Type set to Gateway, the APIs in this environment will not be accessible. To correct the configuration, make changes in Runtime Management to correct the existing Atoms on the environment.

  11. Click Save and Continue.

    The Step 2 Summary page opens to allow you to review the selections you have made so far.

  12. Review your selections and then click Save and Continue to continue to Step 3: Configuring the API.

  13. On the Deployed APIs page, ensure that the APIs deployed to the environment are the ones you expect and that you have the authentication and plans that you expect them to. If the deployed APIs are not as expected, go to the Configure APIs and Applications > Deployed APIs page to make changes. Then, click Save and Continue.

    The Step 3 Summary page opens to allow you to review the selections you have made.

  14. Review your selections and then click Migrate to continue the environment migration.

The environment you selected successfully moved to the specified API Gateway or off its existing API Gateway.

info

The environment name from the Runtime Management page of Integration becomes the Published Name of the environment upon completion of the migration. You can specify a different Published Name for the environment on the Environments panel of the Developer Portal within the Publish page.

If you specify a unique Published Name for an environment on the Environments panel and then migrate that environment to a different API Gateway, it will keep the unique Published Name that you specified.